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I.    INTBODOCTION 

A.       BAMTEK    AND    DI-3000   RELATIONSHIP 

The  Naval  Postgraduate  Schools  Secure  Wargaming 
Analysis  and  Research  Laboratory  (War  Lab),  located  in 
Ingersol  Hall  room  IN-157,  is  eguipped  with  a  high  resolu- 
tion graphics  system.  This  system  consists  of  six  Ramtek 
GM859C  color  monitor  screens,  four  9460  controllers,  and  a 
Precision  Visuals  Incorporated  DI-3000  graphics  software 
system  as  modified  by  Lawrence  Livermore  Laboratories.  The 
DI-3000  runs  on  a  DEC  VAX  11-780  using  the  VMS  operating 
system. 

The  purpose  for  writing  this  tutorial  is  to  provide 
first-time  users  in  the  War  Lab  with  an  introductory  level 
guide  to  using  the  Ramtek/DI-3000  graphics  system,  and  to 
serve  as  a  departure  point  for  programmers  wishing  to  make 
use  of  the  extensive  capabilities  documented  in  Reference  1. 
The    facility  is    available  for   student   and   faculty   use. 

DI-3000  is  a  device-independent  software  package.  This 
independence  theoretically  enables  a  user  to  display 
graphics  output  on  any  type  of  standard  graphics  device  if 
it  is  connected  to  a  DI-3000  supported  computer  system. 
Eecause  the  DI-3000  system  does  not  support  all  Ramtek 
features,  and  because  some  DI-3000  routines  do  not  work  as 
indicated  in  Reference  1,  another  purpose  of  this  guide  is 
to    document  these   differences. 

The  DI-3000  graphics  software  package  is  convenient  and 
easy  to  use.  The  only  background  a  programmer  needs  is  an 
elementary  knowledge  of  Fortran  and  the  ability  to  create 
and      run   a     program    en     the      VAX    11-780.  This   is      because 

DI-3000   is    merely   a    library    of   Fortran-callable  subroutines. 
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An    application    program  calls  DI-3000    subroutines   to   generate 
graphics  images   on    one  or  more  of  the   Ramtek   monitors. 

The  remainder  of  this  chapter  provides  definitions  and 
conventions,  and  explains  general  system  use  in  broad  terms. 
More    detailed   documentation    is  given  in   subsequent   chapters. 

B.       LABORATORY    EQUIP  SENT   OVERVIEW 

The  secure  laboratory  as  typically  configured  is  shown 
in  Figure  1.1.  Variations  to  this  layout  occur  periodi- 
cally, tut  of  interest  is  the  location  of  the  six  Ramtek 
monitors.  At  present,  only  three  unique  images  can  be 
displayed  between  these  six  monitors  because  of  current 
hardware  constraints.  For  example,  monitor  pair  A  and  B  may 
display  an  identical  image,  monitor  pair  C  and  D  may  share  a 
second  image,  and  monitor  pair  E  and  F  a  third  image.  Each 
user  specifies  within  their  program  the  monitor  pair  to  be 
used  to  display  their  graphics  output.  Only  three  programs 
can  display  their  images  on  the  three  monitor  pairs  at  the 
same    time. 

By  energizing  just  one  of  the  monitors  in  a  pair,  for 
example,  A  but  not  B,  a  single  image  will  appear  on  A 
instead  cf  duplicates  on  both  A  and  B.  A  further  descrip- 
tion of  how  to  specify  and  identify  monitors  is  found  in 
Chapter    V. 

The  VT- 100  or  VT-102  terminals  are  the  most  convenient 
for  use  in  conjunction  with  graphics  programming.  They  are 
equipped  with  edit  function  keys  and  are  located  near  the 
Ramtek  monitor  screens  and  the  input  graphic  tablets.  The 
easiest  way  to  get  started  in  the  laboratory  is  to  obtain  an 
account  on  the  VAX  system  from  the  War  Lab  Manager  and 
review  the  laboratory  familiarization  handout  written  by 
LCDR  McCcy.  Copies  cf  this  handout  are  available  in  the  War 
Lab.        Completing  the     CAI    Tutorial   is   also      helpful   so  that 
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unique  features  of  the  VAX  editor  can  be  used  to  create 
DI-3000  Fortran  programs.  The  CAI  tutorial  is  an  interac- 
tive program  found  on  the  VAX  system.  Its  beginning 
instructions  will  appear  on  the  terminal  screen  immediately 
after   log-in. 

C.       RUNNING    A    PBOGBAH 

After  a  Fortran  program  file  is  created  that  consists  of 
DI-3000  subroutine  calls  which  display  a  graphics  image,  the 
file  must  be  compiled,  linked  to  DI-3000,  then  run  in  three 
distinct   steps.  Assume  you      have   created      a  program      file 

identified  as  PICTURE. FOR; 5 ,  and  you  wish  to  run  the  program 
and  display  the  image  on  a  Ramtek  monitor.  First  you  would 
type 

FOR    PICTURE 
This    command  would   compile    your   latest   version  Fortran    file, 
here      number     5,        named        PICTURE.  If      compilation      were 

successful,   the    command   prompt 

$ 
would   appear.        If   net,      errors      would  result.        To   link  the 
DI-3  000   operating  system  to    your   program   you   would  next   type 

SLINK    PICTURE 
If   there   were     no  errors  in    your   use  of      DI-3000,      you   would 
again      see   the      command      prompt.        Then      you      would   run      the 
program   by   typing 

RUN    PICTURE 
Figure    1.2   is  an  example   of      the   control   commands    and   screen 
returns      that   will      fce   displayed      when   successfully      running 
PICTUHE.F0R;5   with    no     errors.         Notice    that   there      are   five 
compilation     warnings     listed.  These     are     normal      system 

responses.  If  other  than  these  warnings  are  listed,  you 
have  generated  an  error  condition  either  in  your  use  of 
DI-3000  or  during  the  compilation  and  run  phase  of  your 
Fortran   program. 


15 


Once  a  program  has  been  successfully  run  at  least  once, 
an  object  file  is  created.  Any  time  the  user  would  then 
desire  to  display  the  image,  only  "running"  the  program 
would  be  necessary.  For  our  previous  example,  only  the 
command 

RON    PICTURE 
would   be  reguired. 

D.       INITIALIZATION    OVEHVIEW 

The  fundamental  DI-300  0  subroutine  calls  define  primi- 
tive objects  and  images  such  as  lines,  polygons,  moves  to  a 
new    screen   position,        written  text,      and   more.  There  are 

three  classes  of  primitives:  polylines,  polygons,  and  text. 
Eolyline  primitives  form  "open-ended"  figures,  while  polygon 
primitives   form   "enclosed"    ones.  Text   primitives   generate 

written  character  information.  A  more  detailed  description 
of  primitives  and  their  applications  can  be  found  in 
Chapters  II,  III,   and  IV. 

Every  DI-3000  program  must  also  consist  of  other  subrou- 
tine calls  necessary  for  these  image  primitives  to  be 
created,      displayed,      or  terminated.  For  the   programmers 

purposes,  this  means  that  each  program  must  have  a  certain 
minimum  seguence  of  commands  for  it  to  run  successfully. 
Figure  1.3  is  an  example  of  a  DI-3000  program  harness  that 
will  display  a  picture  if  the  image  primitive  calls  are 
surrounded    by     the   commands    listed.  These   commands      are  a 

minimum  of  the  calls  a  programmer  can  use,  and  provide  a 
good  reference  for  the  beginning  user.  A  full  explanation 
of  each  can  be    found   in   Chapter  V. 

B.       PBIMITIVES    AHD    CCHPOOHD    IMAGES 

To  create,  say,  a  polygon  primitive  we  would  call  a 
DI-3000    Fortran    subroutine,    named  JPOLGN,    as   follows: 

CALL  JPOLGN(X,  Y,N) 
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Notice  the  existence  of  subroutine  parameters  X,Y,N.    These 
parameters  mean  the  following: 

X  -  The  X  coordinate  positions  (real  array) 
Y  -  The  Y  coordinate  positions  (real  array) 
N  -  Number  of  points  defining  a  polygon  (integer) 
Also,   notice  that  subroutine  parameters  are  of  varying 
types  (real  array  and  integer) .   In  accordance  with  Fortran 
convention,   this  means  parameters  must  be  declared  and 
dimensioned  correctly  at   the  beginning  of  your   program. 
Real,  integer,  and  array  parameters  are  discussed  further  in 
Paragraph  G  below.   A  complete  description  of  the  subroutine 
JPOLGN  can  be  found  in  Chapter  II. 

The  degree  of  complexity  of  an  object  being  created 
determines  the  complexity  of  its  primitive  call.  Objects 
such  as  polygons  are  many-sided,  can  have  different  interior 
and  edge  colors,  and  different  interior  intensities.  These 
characteristics  of  a  primitive  are  examples  of  its  attri- 
butes. Notice  that  we  did  not  specify  the  attributes  of  the 
polygon  when  we  called  JPOLGN  above,  therefore  we  would  have 
no  way  of  knowing  characteristics  like  what  color  polygon  we 
would  create  or  what  the  interior  pattern  would  be.  We  must 
insure  that  these  attributes  are  correctly  defined.  There 
exist,  for  this  purpose,  attribute  subroutines  that  are 
normally  invoked  prior  to  primitive  subroutines.  For 
example,  to  insure  a  solid  interior  pattern  for  all  subse- 
guent  polygons,  we  would  include  in  our  program  the 
following  subroutine  call: 

CALL  JPINTR(1) 
This  attribute  subroutine  and  others   that  are  commonly  used 
are  discussed  in  detail  in  Chapter  III. 

Seldom  is  any  image  created  that  merely  consists  of  a 
single  primitive  shape.  Rather,  most  images  are  composites 
of  several  primitives  that  build  upon  each  other  to  create 
the  final  desired  picture.    Most  of  the  differences  between 
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the  way  the  DI-3000  system  is  supposed  to  work  and  the 
actual  results  obtainable  in  the  War  Lab  are  encountered 
when  the  programmer  tries  to  create  and  display  compound 
image   segments.  A    discussion      of   the      differences,      their 

limitations,  and  ways  to  achieve  desired  outputs  are 
described  in  Chapter   VI. 

P.       ABSOIDTE   AND   RELATIVE   COORDINATES 

EI-3000  subroutines  create  images  for  display  at  a 
defined     location     on     an  output     device.  Most      primitive 

subroutine  calls  can  create  images  based  upon  either  abso- 
lute cr  relative  coordinate  positions.  When  an  image  is  to 
be  created  only  ones,  use  of  either  absolute  or  relative 
positioning  is  appropriate  depending  on  the  user's  applica- 
tion and  preference.  But  when  multiple  copies  of  an  image 
are  desired,  it  would  be  needlessly  repetitive  to  redefine 
each  priaitive  image  for  each  different  position,  therefore 
relative  referenced  primitives  are  used.  Rather  than  using 
absolute  coordinates  the  relative  primitive  creates  an  image 
at  X,Y  positions  relative  to  an  imaginary,  unseen  marker  on 
the  screen.  For  example,  to  duplicate  an  image  you  would 
establish  the  marker,  call  the  relative  primitive,  move  the 
marker,  call  the  relative  primitive  again,  and  repeat  this 
seguence   until   all    images   were  created. 

Primitives  of  absolute  and  relative  parameters  can  be 
distinguished  from  each  other  by  their  formats.  Absolute 
primitives    are   of  the  form: 

JXXXXX         (e.g.    JPOLGN) 
while   relative    primitives  are   of   the   form: 

JRXXXX  (e.g.    JRPLGN) 

Almost  every  attribute  and  capability  of  both  are  identical, 
except  fcr   the    coordinate  position   differences. 
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G.   CONVENTIONS 

1 .  General 

Throughout  this  tutorial,  Reference  1  terminology 
and  format  has  been  maintained  so  that  the  programmer  can 
use  torh  documents  interchangably  when  creating  Ramtek 
graphics  images.  Answers  to  questions  regarding  standard 
VAX  Fortran  convention  can  be  found  in  Reference  2,  located 
in  the  War  lab, 

2.  Display  Coordinate  Systems 

All  images  are  referenced  to  a  world  and  a  virtual 
coordinate  system.  For  our  purposes,  we  will  define  the 
world  coordinate  system  to  be  ±10.0  units  in  the  horizontal 
(X)  direction,  and  ±8.0  units  in  the  vertical  (Y)  direction. 
Therefore,  the  program  grid  is  a  rectangular  display  area 
20.0  units  wide  by  16.0  units  high.  Except  for  maintaining 
the  height-to-width  ratio  of  a  Ramtek  GM859C  monitor  (.8  to 
1.0) ,  cur  choice  cf  dimensions  is  completely  arbitrary, 
whenever  a  primitive  image  is  defined  in  our  program,  it 
will  te  referenced  tc  our  16.0  by  20.0  unit  world  coordinate 
grid. 

He  will  also  use  the  entire  available  Ramtek  monitor 
screen  surface.  This  virtual  coordinate  system  relative  to 
screen  center  will  te  a  rectangular  grid  ±1.0  unit  wide  by 
±.8    units   high. 

Cur  DI-3000  program  will  "translate,"  or  "map"  our 
world  coordinate  picture  onto  the  virtual  coordinate  screen 
by  using  the  JWINDO  command  to  specify  world  coordinate  axis 
values,  and  the  JVSPAC  command  for  virtual  coordinate 
values.  The  use  of  these  commands  is  described  in  Chapter 
V. 
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3.      Subroutines    and   Parameters 

Each  DI-3000  subroutine  will  be  described  in  the 
section   appropriate   to     the    image  type  created.  Each  call 

will  be  briefly  described  as  to  function  and  result,  and  its 
parameters  will  then  be  listed  and  defined  as  to  meaning  and 
type.  The  correct  specification  for  real  number,  integer, 
and  array  variables  within  a  DI-3000  Fortran  program 
follows: 

Integer--A    whole  number    (no    decimal   point) 

Peal  Number--A  number   with  a   decimal    point. 

Array--A  group  of  contiguous  storage  locations  asso- 
ciated with  a  single  symbolic  name  [Ref.  2].  It  must  be 
dimensioned  at  the  beginning  of  the  Fortran  program,  and  it 
can   be   integer   or  real  as   declared. 

Integers  and  real  numbers  can  also  be  variable  names 
referencing  integer    and  real  numbers,    respectively. 

• •      Current    Position 

Primitives  use  and  often  modify  the  current  position 
(CP) ,  a  world  coordinate  point  that  determines  a  "starting 
point."  Unless  otherwise  specified,  a  description  of  a 
primitive  subroutine  call  will  assume  the  return  of  the  CP 
to   its   position    prior  to  the  call. 

If  the  CP  is  placed  outside  the  defined  coordinate 
area,  distorted  images  may  result  when  a  drawing  attempt 
encounters     a  defining     screen  edge.  In   general,        unless 

special  effects  are  desired,  it  is  best  to  insure  all 
created  images    will   "fit"   on  the    screen. 

5  •      Attributes 

Attributes  associated  with  a  primitive  subroutine 
call  will  be  listed  by  attribute  class.  Recall,  primitives 
are    classified   as      pclylines,      polygons,      or   text      and   their 
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attributes  are  specified  based  upon  these  primitive  types. 
System  default  settings  (settings  that  are  initialized  if  no 
attribute  is  specified)    are    also   found   in  Chapter   III. 
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Figure    1.1        Typical  War   Lab  Configuration. 

22 


t— 

f" 

r*» 

r* 

r» 

vO 

VO 

VO 

en 

r- 

w 

CM 

CN 

CN 

t  • 

X 

X 

X 

X 

w 

w 

w 

pq 

w 

X 

• 

• 

• 

• 

w 

a 

a 

Q 

a 

• 

o 

o 

O 

o 

Z 

z 

2 

z 

z 

o 

«" 

CN 

m 

a- 

o 

a 

a 

Q 

Q 

o 

o 

a 

Q 

a 

m 

r— i 

i~-i 

i— i 

i—i 

M 

CQ 

CQ 

OQ 

CQ 

a 

H 

H 

H 

H 

•— i 

hJ 

J 

-J 

.-J 

co 

CO 

CO 

CO 

CO 

H 

X 

X 

X 

X 

j 

CO 

CO 

CO 

CO 

CO 

C_J 

I— 1 

1—1 

I— 1 

X 

CO 

E-t 

E-t 

fr 

E-t 

I— J 

o 

O 

o 

o 

•  t 

O 

O 

o 

O 

E-t 

03 

03 

a; 

cc 

o 

CO 

CO 

CO 

CO 

wo  cox  wx  cox  cox 
D«3  OTO  CTCO  cjto  erco 
C  CO  CW  C  W  C«  cs  «*■ 
•H  X«H  CO-H  CO-HCO-H  CO 
CSCO  CSX  CSX  CSX  CSX 
MM  MCO  MCO  MCO  MCO 

«jco  <d     td     <d     <d 
»x  s  <p  :*  <»  »  a>  *  a> 

CO  cH  iH  r-l  cH 
CS  CS-H  C'H  CS-H  CS-H 
O  0)  0«W  0«M  OM-I  0<4-4 
•HiH-H      -H      -H     -H 

4J-H+JQ4JQ+JQ4JQ 

<d«M  (dO  cdO  <dO  (dO 

rH      H2HZH2HZ 
•Hrn-H'-'HCN-Hro-H  if 

cuh  q-£j  cla  aa  aa 
bqbqeq  aa  a  a 
u      o      u     o     u 
u  a>  u  <d  u  a>  oa)  u  a) 


pa 

03  CO 

Haas 

CCE-tH 

suz 

EHfHCC 

M        I 

04fcS3S 
Z   I 

P4COM 


3    »=J    »*3 
T3CO*OCOt3 

oaoKo 

aw  spas 

z     z 

C05CQ5C 
H3S-H3E-H 
I         I 
3      3 
I  I 

££  ^ 
Z  Z 
M      M 


»=5  »3 
COT3COT3 
03OQ3  OW 

wsw  eos 
z    z     s 

03C3O3  CSH 

I  I  H 
2  36  04 
I         I 

MS    u:    z 

Z      Z      3 

M     M     m 


CS 
03 

a 
id 

M 
D> 
O 
M 
& 

M 
O 
«H 

CO 
CS 
M 
9 

■P 
(U 

D3 

•o 

CS 

<d 

co 

a 
td 

a 
a 
o 
u 

X 

> 


CN 


M 


23 


C    PROGRAM    HARNESS    EXAMPLE 
C 

INTEGER    MON 
C 

C  INITIALIZE  A  RAMTEK  MONITOR 
C 

TYPE  *,  • ENTER  THE  MONITOR  NUMBER* 

ACCEPT  *,  MCN 
C 

C  BEGIN  MANDATORY  INITIALIZATION  CALLS 
C 

CALL  JBEGIN 

CALL  JFILES  (3,1, MON) 

CALL  JDINIT  (1) 

CALL  JDEVON  (1) 

CALL  JDCOLR  (2) 

CALL  JVSPAC  (-1.0.1  .0,-.8.  .8) 

CALL  JWINDO  (-10.0,  10.0,-8.0,8.0) 

CALL  JROPEN  (1) 
C 
C 
C 
C 

C  (INSERT  YOUR  PRIMITIVE  CALLS  HERE  FOR 
C  IMAGE  CREATION) 
C 

c 
c 

C     (ALSO,    INSERT    YCDR    REQUIRED    ATTRIBUTES 

C    EASED    UPON    ATTRIEUTE    CLASS    AS    DESCRIBED 

C    IN    CHAPTER    III.) 

C 

C 

C    ALL    PRIMITIVE    CALLS    INSERTED    HERE    ARE 

C    WITHIN    OPEN    RETAINED   SEGMENT    NUMBER    1. 

C 

c 

CALL    JRCLOS 

CALL   JPAUSE  (1) 

CALL    JEND 

END 
C 

C    THIS    PROGRAM    DRAWS    IN    DEFAULT    GREEN    AND    USES 
C    RETAINED    SEGMENT    (NUMBER    1)  . 
C 


Figure    1.3        Minimum  Necessary   DI-3000   Subroutine   Calls. 
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II.    NON-TEXT   PRIMITIVES 


A.       GEHEBAL 


Primitive  routines  are  used  by  the  programmer  to 
describe     objects.  Character-based     objects      (text)         and 

graphics  objects  (non-text)  are  the  two  most  common  primi- 
tive types.  They  are  distinguished  not  only  by  the  images 
they  create,  but  by  how  they  are  specified  and  used.  This 
chapter  describes  non-text  primitives.  Chapter  IV  provides 
details   to    display   text. 

As  discussed  in  Chapter  I,  DI-3000  non-text  primitives 
often  define  images  in  one  of  two  ways.  A  figure  can  be 
defined  using  absolute  world  coordinate  position  values,  or 
it  can  re  expressed  in  world  coordinate  position  values 
relative  to  the  current  position  (CP) .  First  some  elemen- 
tary primitive  subroutine  calls  will  be  described  followed 
by  examples  that  will  illustrate  the  difference  between 
absolute  and  relative  expressions. 

All  primitives  will  be  created  based  upon  the  most 
recent  attribute  definitions.  For  example,  if  we  specify 
line  color  to  be  blue,  then  all  lines,  figures,  and  text 
will  be  drawn  in  blue.  If  we  wish  to  draw  a  blue  line  and 
then  a  red  line,  we  must  set  the  line  color  attribute  to 
blue,  draw  the  blue  line,  change  the  line  color  attribute  to 
red,    then   draw    the   red  line. 

Ncn-text  primitives  and  their  attributes  are  grouped 
into      two   major     classes:  polyline      and   polygon.  Their 

differences   are    described  in  Chapter   III. 
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B.       BOVING    THE    CURRENT    POSITION    (JHOVE/JRMOVE) 

1 .  Description 

JMOVE/JRMOVE  are  the  subroutines  used  to  move  an 
invisible  reference  point  from  the  current  position  to  a  new 
current  position.  The  commands  establish  a  reference 
position. 

2.  Ose 

CALL    JMOVE (X,Y)  (Absolute) 

or 
CALL    JBMOVE(DX,DY)  (Relative) 

3-      Parameter  Definition 

X,Y         (Real) 

The  world  coordinate  position  that  will  become  the 
new  current  position. 

DXrDY    (Real) 

The  amount  cf  displacement  from  the  previous  posi- 
tion to  the  new  current  position. 

U .   Discussion  Example 

If  the  current  position  is  at  world  coordinate  posi- 
tion (1.0,2.0),  and  we  want  to  establish  a  new  CP  at 
(3.0,7.0)  we  would  use  either  of  the  following  subroutine 
calls: 

CALL  JMOVE  (3.0,7.0) 

or 
CALL  JRMOVE(2. 0,5.0) 
Note  that  the  relative  call  JRMOVE  merely  adds  its 
parameter  values  to  the  current  position.  For  example, 
1.0+2.0=3.0  and  2.0+5.0=7.0  results  in  the  new  X,Y  world 
coordinates  of  (3.0,7.0).  The  absolute  call  JMOVE  changes 
position   directly  to.  its  parameter   values. 
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Current  position  can  be  moved  to  X,Y  coordinates 
outside  the  specified  viewport  (for  example,  X>10.0  or 
Y>8.0).  This  technique  is  often  useful  for  creating  unusual 
images  such  as  "gradual"  arcs  of  large  radius,  but  distor- 
tion will  result  when  the  created  shape  reaches  tha  viewport 
boundary. 

C.       DRAWING    A   LINE     ( JDHAW/J RDRAi) 

1 .  Description 

JDRAW/JRDRAW  are  the  subroutines  used  to  draw  a 
visible  line  from  the  current  position  to  a  new  current 
position. 

2.  Use 

.     CALL    JDRAW(X,Y)  (Absolute) 

or 
CALL    JRDRAW(DX,DY)  (Relative) 

3.  Parameter  Definition 

X,Y         (Real) 

The  world  coordinate  position  that  will  become  the 
new  current  position.  A  line  is  drawn  from  the  old  current 
position  to   this  new   CP. 

DX,DY         (Real) 

The  amount  of  displacement  from  the  previous  current 
position  to  the  new  current  position.  A  line  is  drawn  from 
the  old  CP  to  this  new  CP. 

4 .  Required  Attributes 
Polyline  class. 
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5,      Discussion    Example 

If   the   current   position  is   at   world  coordinate    posi- 
tion   (-1.0,-4.0)       and     we  want  to  draw   a   line      from   there  to 
new    position   (2.0,0.0),      then   to      a  third   and   final   position 
(5.0,-2.0)      we    could   use  either      of   the    following   subroutine 
call    sequences: 

CALL   JDRAW(2. 0,0.0) 
CALL  JDRAW(5. 0,-2.0) 

or 
CALL  JRDRAW(3. 0,4.0) 
CALL  JRDRAW  (3.0,-2.0) 
Any     correct   combination      of     absolute  and     relative 
calls   could  also   have  been    used.      For  example: 

CALL  JDRAW  (2.0,0.0) 
CALL   JRDRAW  (3.0,-2.0) 
Figure    2.1    shows  the   picture     that   would    result   from 
any    of  the   above  three  call    sequences. 

The  attributes  of  the  line  would  correspond  to  these 
attributes  already  established  prior  to  invoking  the 
JDRAW/JRERAW  primitives. 

Note  that  a  color  attribute  must  be  specified  by 
using  zhe  JCOLOR/JDCOLR  routines  as  described  in  Chapter 
III. 

CP  is  changed  to  the  final  X,Y  coordinate  position 
cf   the   drawn  line. 

D.       DRAWING   CONNECTED   LINES     (JPOLY/JRPOLY) 

1 .      Description 

JP01T/JRPOLI  are  the  subroutines  used  to  draw  a 
connected  sequence  of  visible  lines,  known  as  a  polyline 
segment. 

Note:   the  subroutines   do   not   create   polygons. 
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2.  Use 

CALL   JPOLY(XrY,N)  (Absolute) 

or 
CALL  JRPOLY (DX,DY,N)  (Relative) 

3.  Parameter  Definition 

X,Y        (Real,    Array) 
The     arrays    contain      the     absolute    world      coordinate 
positions  that   define  the  points   of   the    polyline. 

DX,DY         (Real,    Array) 
The  arrays    contain    the     relative   amount   of   displace- 
ment   from   the  previous  polyline   point   to   the   next    point   that 
defines   the   polyline. 

N         (Integer) 
The  number    of  points  in  the   polyline   segment    (not   to 
include   the   first  current  position   point) . 

The  above  arrays  must  be  dimensioned  to  at  least  the 
value   of   N. 

4 .  Required  Attributes 
Polyline  class. 

5 .  Discussion    Example 

Polylines  and  polygons  differ  in  that  polygons  are 
always  enclosed  figures.  Polygons  are  also  "filled"  in 
color  and  will  be  described  later  in  this  chapter. 

Polylines  are  created  using  a  single  JPOLY/JRPCLY 
subroutine  call  rather  than  a  sequence  of  JDRAW/JRDRAW  calls 
as  before. 

Once  again  we  will  create  the  image  shown  in  Figure 
2.1,  but  this  time  only  a  single  subroutine  will  be  needed. 
Notice,  though,  that  now  the  defining  polyline  coordinate 
pairs   are  held   in  array   variables.    Also  note  that  the 


29 


initial  polyline  position  is  defined  as  the  current  posi- 
tion, (-1.0,-4.0)  again,  and  is  not  included  in  the  array 
variable  coordinate  pairs.  Either  of  the  following  subrou- 
tines  will   define  the  required  connected  line: 

CALL  JPOLY(X,Y,2) 
where  X    and      Y   are    both  two   element     arrays   with   the 
following   values: 

X<1)=2.0        Y(1)=0.0 
X(2)=5.  0        Y(2)=-2.0 

or 
CALL   JRP0LY(DX,DY,2) 
where  DX  and   DY   are   both   two-element  arrays   with  the 
following   values: 

DX(1)=3.0        DY(1)=4.0 
DX(2)=3.0        DY(2)=-2.0 
The  above  arrays  must   be      dimensioned   in    the  calling 
program   in    accordance   with    standard   Fortran.      For   example: 
DIMENSION    X(2)  ,Y  (2)  ,DX(2)  ,DY  (2) 

or 
REAL  X(2)  ,  Y(2)  ,DX(2)  ,DY(2) 
The  N  variable  is  defined  as  the  dimension  of  the 
X,Y  or  DX,DY  arrays.  Every  sequence  of  lines  consists  of  a 
beginning  point,  a  series  of  "breaking"  points,  and  an  end 
point.  The  beginning  point  is  the  current  position  and  is 
not  included  in  the  array  variables.  All  other  coordinate 
pairs   are   included. 

CP   is     changed  to  the     last   X,Y      coordinate   polyline 
point. 

S.       DBA  WING    AH    ABC    LINE     (JABC) 

1 .      Description 

JARC  is      the   subroutine      used  to      draw  an      arc   of     a 
circle.        An     arc  line     is    drawn     counterclockwise   from     one 
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angle  position  to  another,  with  a  specified  radius,  from  a 
specified  invisible  circle  center. 

2.  Use 

CALL   J  ARC  (X,Y,  0.0,  RADIUS,  NSEG,  A0,  A1) 

3.  Parameter  Definition 

X,Y         (Real) 

The  world  coordinate  center  of  the  circle  from  which 
the   arc   is   to  be  drawn. 

0.0         (The    real   number  zero) 
RADIOS         (Real) 
The   radius    of  the  arc   in    world  coordinates. 

NSEG         (Integer) 
The  number      cf  line    segments      to   be   used      in    drawing 
the    arc.  If    NSEG<1     the    arc      will   be      smooth   because      the 

maximum  number  of  segments  possible  will  be  used  to  draw  a 
smooth  curve.  If  NSEG>=1  then  the  arc  will  be  drawn  with 
NSEG    flat,    straight    lines. 

A0,A1         (Real) 
The  angles   in  degrees   defining     the  span   of  the  arc. 
Positive  angles   are    measured  counterclockwise   from   the    posi- 
tive   X   axis  of    the    world     coordinate   system.        Arc   lines   are 
drawn   counterclockwise  from    angle   A0   to    A1. 

4.  Required   Attributes 
Eolyline  class. 

5.  Discussion    Example 

The  JARC  and  JSECTR  subroutines  are  very  similar, 
and  care  must  be  taken  to  avoid  confusing  them.  JARC  does 
not  draw  a  filled  wedge,  but  merely  defines  a  section  of 
circle  edge  (the  outside  arc).  If  a  "pie  shaped"  wedge  is 
desired,  then  the  subroutine  JSECTR  is  used. 
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If  a  360  degree  circle  is  desired,  then  parameters 
A0  and  A1  can  be  specified  close  enough  together  so  that  any 
space  between  them  will  not  appear  on  the  screen.  Their 
values  will  be  world  coordinate  dependent.  An  easier  way  to 
create  a  circle  is  to  use  the  JCIRCL  subroutine  and  specify 
"no  polygon  fill"  as  described  later  in  this  chapter. 

Note  that  an  arc  should  lie  within  the  already 
defined  wcrld  coordinate  window  if  it  is  to  be  drawn  undis- 
torted.  This  means  that  very  large,  gradual  arcs  cannot  be 
created  simply  by  defining  a  center  far  away  from  the  image 
("off  the  screen") .  Though  the  large  arc  will  have  the 
correct  shape  through  its  curvature,  if  it  exceeds  the  world 
coordinate  viewing  area  it  will  distort  at  the  boundary 
edge.  The  technique  of  viewing  transformation  should  be 
used  to  avoid  this  distortion,  an  explanation  of  which  can 
be  found  in  Chapter  V. 

F.   DRAWING  A  POLYGON  (JPOLGN/JRPLGN) 

1 .   Description 

JPOLGN/JBPLGN  are  the  subroutines  used  to  draw 
filled  or  unfilled  pclygons.  All  defined  points  and  the  CP 
are  connected  to  form  an  enclosed  figure.  This  is  accom- 
plished by  an  "implicit"  final  draw  from  the  last  specified 
point  in  the  polygon  to  the  initial  polygon  creation  point 
(CP)  .  The  image  can  be  filled  with  a  color  and  pattern  as 
described  in  Chapter  III. 

Note  that  the  subroutines  can  create  polylines  if 
the  "no  fill"  attribute  is  specified,  but  unlike  polylines, 
polygons  will  always  define  an  enclosed  figure. 


2.   Use 


CALL    JPCLGN(X,Y,N)  (Absolute) 

or 
CALL   JRPLGN  (DX,DY,N)  (Relative) 
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3.      Parameter  Definition 

X,Y        (Real,    Array) 
The  arrays      of  world     coordinate  absolute      positions 
that    define  the    points  of  the   polygon. 

DX,DY         (Real,    Array) 
The   arrays      cf  displacement   from   the     previous    posi- 
tion   to    the   points    that   define   the   polygon. 

N        (Integer) 
The   number      of   points      in  the      polygon.        The      above 
arrays   must  be    dimensioned    by   at   least  the   value   of   N. 

*•      Required  Attributes 

Polygon    class. 

5 •      Discussion    Example 

A  polygon  is  defined  as  a  move  from  the  current 
position  to  the  first  point  (as  specified  by  the  array  vari- 
ables X(1),Y(1)  or  DX  (1)  ,  DY  (1)  )  ,  draws  to  the  remaining 
array  points,  and  a  final  implicit  draw  from  the  last  point 
tack    tc   the   first   point. 

Assume  we  wish  to  draw  the  five  sided  polygon  shown 
in  Figure  2.2.  Let  current  position  be  given  initially  as 
the  absolute  world  coordinate  position  (1.0,2.0).  Either  of 
the    following   subroutines  will  create   the   polygon. 

CALL  JPOLGN(X,Y,5) 
where   X   and    Y  are  both      five   element   arrays   with  the 
following   values: 

X(1)=2.0  Y(1)=3.0 
X(2)=3.0  Y(2)=U.O 
X(3)=5.0  Y(3)=5.0 
X(4)=6.  0  Y(4)  =3.0 
X(5)=4.0        Y(5)=1.0 

or 
CALL   JRPLGN(DX,DY,5) 


33 


where  DX  and  DI  are  both  five  element  arrays  with 
the    following  values: 

DX(1)=1.0         DY(1)=1.0 
DX(2)=1.0        DY(2)=1.0 
DX(3)=2.0        DY(3)=1.0 
DX(4)=1.0         DY(4)=-2.0 
DX(5)=-2.0      DY(5)=-2.0 
Notice    that   relative  array   values      merely   add   to   the 
previous  position  value  to    create  a   new   coordinate   position. 
When  JPOLGN    is  finished,        the   current  position    (CP) 
is   set     to   the      value  of  X(1),Y(1),        the   first      point,      but 
JRPLGN   returns    the    initial   CP. 

Polygons  can  be  convex  or  concave.  Their  defining 
points  can  create  intersecting  lines,  but  the  created  shape 
will  not  correctly  "fill"  in  most  of  those  cases.  Polygons 
must    have   at  least   three   points. 

Note  that  absolute  polycjon  routines  do  not  use  the 
CP  at  all.  They  reguire  X,Y  array  specification  of  all 
points.  Polyline  routines  use  the  CP  as  their  first  point, 
and    do   not   include    it  in  their  X,Y  arrays. 

G.       DRAWING    A    RECTANGLE    (JBECT) 

1 .  Description 

JRECT  is  the  subroutine  used  to  draw  a  horizontal/ 
vertical  rectangular  polygon.  It  is  an  easier  subroutine  to 
use  than  JPOLGN  because  only  two  X,Y  position  pair  variables 
are  reguired;  the  diagonally  opposite  corners  of  the 
rectangle. 

2.  Ose 

CALL  JRECT  (XO,  YO,  X1  ,  Y  1) 
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3 .      Parameter  Definition 

X0,Y0        (Real) 
One   corner   of  the  rectangle. 

X1,Y1         (Real) 

The   diagonally  opposite   corner  of   the   rectangle. 

*■      Required   Attributes 

Polygon    class. 

5 .      Discussion 

JRECT  is  included  in  this  text  as  an  effort-saving 
subroutine  for  creating  horizontal/vertical  rectangles. 
Note  that  the  variables  are  not  arrays,  but  merely  values. 
Also,  there  is  no  counterpart  subroutine  with  opposite 
corners  defined  relative  to  the  CP.  If  more  than  one  iden- 
tical rectangle  is  reguired,  the  JRPLGN  subroutine  must  be 
used. 

H.        DEASING    A    CIRCLE     (JCIRCL) 

1 .  Description 

JCIRCL  is  the  subroutine  used  to  draw  a  circular 
polygon.  The  created  shape  is  connected  to  form  an  enclosed 
figure.  The  image  can  be  filled  with  color  and  pattern. 
Outlined  circles  can  be  created  if  no  fill  is  specified. 

2.  Dse 

CALL  JCIRCL  (X0,Y0, 0.0, RADIOS rNSEG) 

3.  Parameter  Definition 

X0,Y0         (Real) 
The     center        position     of        the      circle        in      world 
coordinates. 
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0.0   (The  real  number  zero) 
RADIOS    (Real) 
The  radius  of  the  circle. 

NSEG    (Integer) 
The  number  of  line  segments  to  be  used  when  drawing 
the   circle.     If  NSEG<3   a   smooth  edged  circle   will  be 
created.    If  NSEG>=3,  the  outer  edge  of  the  circle  will  be 
drawn  with  NSEG  flat,  straight  lines. 

4.  Required  Attributes 
Eclygon  class. 

5.  Discussion  Example 

Figure  2.3  shows  examples  of  figures  that  can  be 
created  using  the  JCIRCL  subroutine.  The  program  segment 
shown  in  Figure  2.4  was  used  to  create  Figure  2.3.  Notice 
that  triangles,  squares,  and  any  N-sided  figure  can  be 
formed  by  altering  the  value  of  parameter  NSEG.  All  images 
are  oriented  towards  the  X  axis.  For  example,  the  first 
triangle  tip  lies  on   the  axis   at   point    (RADIUS, 0.. ) . 

Also  note  that  a  smooth  circle  was  formed  by  setting 
NSEG=1,  and  that  all  the  examples  were  drawn  using  the  same 
center   pcint  and  with  the  "no   fill"   attribute   specified. 

For  creation  of  circle  portions,  like  "pie  slices" 
of  a  circular  polygon,  refer  to  the  JSECTR  subroutine.  For 
simple   partial   arc   lines  refer  to  the  JARC   subroutine. 

I.       DRAWING    A   CIRCLE    SECTION    (JSECTR) 

1 .      Description 

JSECTR  is  the  subroutine  used  to  draw  a  section  of  a 
circular  polygon.  This  shape  is  often  used  in  the  creation 
cf   "pie  charts",    where  part   of   a   filled   circle  is    needed. 
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2.  Use 

CALL    J SECT F  (XO,YO ,0. 0, RADIOS, NSEG,A0, A1 ) 

3 .  Earameter  Definition 

X0,Y0        (Real) 

The  world  coordinate  center  of  the  circle  from  which 
the    section  is   to  be   drawn, 

0.0         (The    real   number  zero) 
RADIOS         (Real) 
The   radius    of  the  circle    section, 

NSEG         (Integer) 
The   number   of  line    segments      to    be   used  when   drawing 
the   outer   arc      portion  of  the   section.        If      NSEG<1    a   smooth 
edge    will      be  created.      If    NSEG>=1,        the   outer  arc     will  be 
defined   using  NSEG   flat,    straight  lines. 

A0,A1         (Real) 
The   angles,      in     degrees,      defining  the   span      of  the 
section.      Positive   angles  are   measured  counterclockwise   from 
the      positive      X     axis     of        the      world      coordinate      system. 
Sections   are  created   counterclockwise   from   A0   to    A1. 

4 -      Discussion    Example 

For  complete  360  degree  circles  refer  to  the  JCIRCL 
subroutine.  For  simple  unfilled  arc  lines  refer  to  the  JARC 
subroutine. 

Figure  2.5  is  an  example  of  a  circle  section  created 
by  the   following  subroutine   call: 

CALL    JSECTR  (1.0, 2. 0,0. 0,3. 0,1, 10. 0,50.0) 
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CALL    JCIRCL(0.,0.  ,0.,6.5,2) 
CALL    JCIRCt  (0.,0.  ,0. ,5.5, 15) 
CALL    JCIRCL  <0.,0.  ,0.  ,4.5,8) 
CALL    JCIRCL   0.,0. ,0.,3.5,5 
CALL    JCIRCL(0.,0. ,0. ,2.5,4. 
CALL    JCIRCLfO.  ,0.  ,0. ,1.5,3 


Figure  2.4       Circle  Creation  Program. 
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Ill-  ATTRIBUTES 

A.  GEHEBAL 

Attributes  define  primitive  image  characteristics. 
Examples  of  attributes  are  "continuous"  vs  "dashed"  lines, 
or  even  color  itself.  There  are  many  different  attributes 
possible,  and  they  are  all  set  using  DI-3000  subroutine 
calls.  The  specifications  described  in  this  chapter  will 
primarily  apply  to  non-text  primitives,  but  in  several 
instances  both  text  and  non-text  will  share  the  same  call. 
Text-cnly   attributes   are  discussed  in  Chapter  IV. 

B.  BEFADLT  AND  CURRENT  ATTRIBUTE  VALUES 

Each  primitive  attribute  has  one  of  two  values,  a 
default  value  and  a  current  value.  The  default  value  is  set 
automatically  when  DI-3000  is  initialized  (with  the  required 
JBEGIN  subroutine) ,  and  remains  in  effect  unless  changed 
before   the   first  program  segment   has   been   opened. 

A  program  segment  is  a  program  section  and  a  graphics 
data  structure.  It  contains  a  sequence  of  primitive  calls 
that  cr€ate  a  graphics  sub-image  of  logically  related 
objects,  and  is  always  used  when  creating  images.  Breaking 
down  a  ccmplex  picture  into  program  segments  simplifies  the 
creation  procedure  and  aids  understanding.  It  is  required 
in      all        DI-3000      programs.  A      detailed        discussion     of 

segmenting  can  be  found  in  Chapter  VI,  but  for  our  purposes 
the    fcllcwing   brief    example    should   suffice. 

Assume  a  programmer  wishes  to  draw  a  green  square  in  the 
upper  right-hand  portion  of  the  screen,  and  a  red  semicircle 
in  the  center.  One  method  for  accomplishing  this  would  be 
to   create   a   segment    for  each  primitive   image. 
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Let  segment  number  one  be  for  a  square,  and  segment 
number  two  for  a  semicircle.  As  discussed  in  Chapter  II  we 
would  use  the  appropriate  subroutine  calls  for  these  image 
primitives  within  each  created  segment.  But,  so  far  we  have 
not  explained  how  to  specify  different  image  colors  using 
DI-3000   attributes. 

Cne  method  would  be  as  follows.  Set  the  default  color 
to  green,  begin  (open)  the  first  segment,  create  and  display 
the  square,  and  end  (close)  the  first  segment.  Then,  change 
the  default  color  to  red,  open  the  second  segment,  create 
and  display  the  semicircle,  and  close  the  second  segment. 
This  method  would  not  work  because  DI-3000  does  not  permit 
changing  the  default  color  once  the  first  segment  has  been 
opened.  Therefore,  we  would  have  to  change  the  current 
attribute   color    "within"   the   second  segment  to  red. 

Any  further  segments  would  again  be  drawn  in  default 
color  green,  unless  the  current  color  attribute  was  changed 
within  ttem.  A  program  excerpt  that  creates  our  example  is 
shown   in  Figure    3.1 

Default  values  are  usually  set  by  the  programmer  to  the 
most  ccmmon  image  attribute.  If  a  complex  picture  will  be 
predominantly  of  one  color,  then  that  default  color  will  be 
set.  Only  images  of  different  colors  will  need  to  be  speci- 
fied later  using  the  current  color  attribute  calls  within 
segments. 

Most  default  attributes  are  automatically  set  to  their 
most  ccmmon  values  when  a  DI-3000  program  is  begun  and  are 
usually  not  changed.  These  initial,  automatic  settings  are 
listed  in   the  description   of  each  attribute  call. 

Default  and  commcn  attribute  value  subroutine  calls  can 
be  distinguished  from  each  ether  by  their  format.  Default 
attributes   are   set    using  the   form: 

JDXXXX         (e.g.    JDCOLR) 
Current   attribute   calls   are   of  the   form: 

JXXXXX         (e.g.    JCOLOR) 
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Current     attribute      values      can     be        changed     as      often     as 
necessary   within  segments. 

C.  POLYLINE   AND   POLYGON   ATTRIBUTE   CLASSES 

Non-text  attributes  apply  to  either  polygon  or  polyline 
primitive  images  and  are  classified  as  such.  As  described 
in  Chapter  II,  polygon  images  always  result  in  the  creation 
of  an  enclosed  figure,  while  polyline  images  do  not 
necessarily. 

Throughout  this  chapter,  a  detailed  description  of  the 
polyline  class  will  first  be  given,  followed  by  the  polygon 
class.  Attribute  characteristics  are  listed  by  these  two 
classes  in  the  primitive-  descriptions  in  Chapter  II. 
Therefore,  a  programmer  can  first  refer  to  the  discussion  in 
Chapter  II  of  the  image  to  be  created,  then  cross-reference 
to  this  chapter  by  attribute  class  for  methods  that  will 
specify   image   characteristics. 

D.  POLYLINE  COLOR     ( JCOLOR/ JDCOLR) 

1  •      Description 

JCCLOR/JDCOLB  are      the   subroutines      used   to      set   the 
current/default    polyline  primitive  color  attribute. 

2.  Use 

CALL   JCCLOR(C VALUE)  (Current) 

or 
CALL    JDCOLR (D VALUE)  (Default) 

3.  Parameter  Definition 

CVALUE         (Integer) 
The   color  index  of      subseguent   primitives    within  the 
currently  open    segment.       (0<CVALUE<8) 

DVALUE         (Integer) 
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The  new  value  for  the  default  color  index.  When  a 
segment  is  opened,  the  color  index  is  set  to  DVALOE. 
(0<DVALOE<8) 

4 .  Applicability 

Applies  to  draws,  polylines,  polygon  edges,  and  text 
primitives. 

5.  Initialization  Default  Value 

DVALOE=0         (Background   color) 

6 .  Discussion 

The  following  eight  entries  in  the  color  lookup 
table  are  downloaded  to  the  graphics  processor  by  setting 
CVALOE/DVALOE  to  any  cf  the  following  integer  values: 

0  —  Background  (No  color) 

1  —  Red 

2  — •  Green 

3  —  Yellow 

4  —  Magenta  (Dark  Blue) 

5  —  Purple 

6  —  Cyan  (Light  Blue) 

7  —  White 

8  —  Background  complement  (White  also) 
JDCOLR  at  program  beginning  or  JCOLOR   within  each 

segment  must  be  specified.  If  not,  no  image  will  appear, 
because  JDCOLR  initialization  default  value  is  0  and  primi- 
tives will  be  drawn  in  background  color. 

The  default  entries  in  the  color  table  are  limited 
as  described  (at  present)  .  Ramtek  is  capable  of  creating 
many  different  colors  (any  hue,  lightness,  or  saturation 
desired) ,  but  for  simplicity  in  this  tutorial  a  discussion 
cf  how  to  accomplish  this  is  not  included.  For  further 
information,   refer  to  the  Reference   1   description  of 
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subroutine  JCOTBL  (creating  a  color  table)  . 

<0<CVALOE/DVALOE<32767)  is  the  actual  range  of  permissible 
values,  but  to  utilize  any  value  >8  your  color  table  must 
first  be  defined.  If  this  definition  is  not  done,  the 
colors   called  by  values   >8    will  be   unpredictable. 

E.       POLYLINE  STILE     ( JLSTYL/JDLSTY) 

1 •      Description 

JLSTYL/JDLSTY  are  the  subroutines  used  to  set  the 
current/default  polyline  primitive  line  style  attribute. 
Lines  can  be  continuous  or  a  combination  of  varying  lengths 
of    "dotted"  or    "dashed"   portions. 

2.  Use 

CALL   JISTYL(C VALUE)         (Current) 

or 
CALL    JDLSTY(DVALOE)  (Default) 

3.  Parameter  Definition 

CVALOE         (Integer) 
The   line      style   of    subseguent   primitives      within  the 
currently  open    segment.       (0<CVALUE<32767) 

DVALUE         (Integer) 
The  new    value     for    the   default   line      style.         When  a 
segment     is  opened,        the     line  style     is     reset    to      DVALOE. 
(0<DVALDE<32767) 

* •      Applicability 

Applies  to  polyline  primitives  only.  Does  not  apply 
to    polygon   edges,   or   any  text. 
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5.  Initialization  Default   Value 

DVALUE=0  (Solid    line) 

6 .  Discussion 

The  Ramtek.  provides  a  multitude  of  different  line 
styles.  As  CVALOE/DVALOE  values  are  increased  the  spacing 
between  "dots"  and  "dashes"  increases,  as  does  their  length 
and   sequence.  Every  value     that  is  a      multiple   of      8  will 

result  in  a  solid  line,  with  a  new  combination  of  styles  to 
follow.  It  is  best  to  experiment  with  available  values  to 
find  the  exact  desired  line  style,  but  in  general  a  value  of 
CVAL0E/DVALUE=7  gives  a  good  "dotted"  line  that  is  easily 
distinguishable    from   normal    "solid"   lines. 

P.       POLYLINE  INTENSITY.    (JINTEN/JDINTE) 

1 .      Discussion 

JINTEN/JDINTE  do  not  alter  line  intensity  as 
described  in  Reference  1.  To  vary  intensity,  a  color  table 
must    be  created. 

G.       POLYLINE   WIDTH     ( JLBIDE/JDLHID) 

1  •      Discussion 

JLWIDE/JDLSID  do  not  alter  line  width  as  described 
in  Reference  1.  To  vary  line  width,  the  JWINDO  command  must 
be  used  to  "blow  up"  or  "shrink"  image  size  by  changing 
world      coordinate  size.  This     technique      is  explained     in 

Chapter   V. 
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H.       POLIGON    EDGE  COLCR   STYLE    (JPEDGE/JDPEDG) 

1  •      Description 

JPEDGE/JDPEDG  are  the  subroutines  used  to  set  the 
current/default  polygon  edge  (border)  color  style.  Edge 
color  style  is  of  two  types:  "same  as"  or  "different  than" 
polygon   interior  colcr. 

2.      Dse 

CALL   JPEDGE(CVALUE)  (Current) 

or 
CALL    JEPEDG(DVALUE)  (Default) 

3-      Parameter  Definition 

CVALOE         (Integer) 
The   polygon    edge   color      style   of   subsequent    polygons 
within   the    currently   cpen   segment.       (0<CVALOE<32767) 

EVALUE         (Integer) 
The   new      value   for      the   default      polygon    edge      color 
style.      When  a    segment  is  opened,    the   edge   style    is   reset  to 
DVALOE.        (0<DVALUE<3  2767) 

U .      Applicability 

Applies    only   to   polygon   primitives. 

5-      Initialization  Default   Value 

DVAL0E=0       (Border   Visible) 

6  •      Discussion 

Polygons  are  drawn  with  their  borders  either  of  the 
same  colcr  as  their  interiors,  or  of  different  colors.  If 
the  same  color  is  specified,  the  border  will  be  invisible. 
If  not,  the  border  will  form  an  edge  of  different  color 
around  the   polygon. 
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The  following  CVALUE/DVALUE  values  are  used  to 
specify   edge  style: 

Odd   —    Invisible   border. 
Even  —    Border   visible. 
The     polygon   edge      takes   on      the  characteristics     of 
current   color  when    visible.        Therefore,      polyline   attribute 
JCOLCR/JDCOLR  determines     polygon  edge      color   in      the   "Even" 
style. 

I.       POLYGON    INTERIOR    STILE     (JPINTR/JDPINT) 

1 •      Description 

JPINTR/JDPINT  are  the  subroutines  used  to  set  the 
current/default  polygon  interior  style  attribute.  Interior 
style  is  either  "empty"  (no  fill,  background  color) ,  or 
"filled"  (using  an  interior  color  as  specified  by  the 
JPIDEX/JDPIDX  subroutine  calls). 

2.  Use 

CALL    JPINTR(C VALUE)  (Current) 

or 
CALL    JDPINT(DVALOE)  (Default) 

3 .  Parameter  Definitions 

CVALOE         (Integer) 
The   polygon      interior   style      of   subsequent      polygons 
within   the   currently  open   segment.       (CVALUE=   0  or    1) 

DVALUE         (Integer) 
The     new      value     for  the     default      polygon      interior 
style.        When     a  segment  is     opened,      the   interior      style  is 
reset   to   DVALUE.       (DVALUE=    0   or    1) 
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<* .   Applicability 

Applies  only  to  polygon  primitives. 

5-   Initialization  Default  Value 

DVALOE=0   (No  polygon  fill) 

6 .   Discussion 

Fully  connected  lines  can  be  created  by  specifying 
the  "no  fill"  polygon  attribute.  .  When  polygon  fill  is 
desired,  the  color  of  the  fill  is  determined  by  using  the 
JPIDEX/JDPIDX  subroutines  as  next  described  in  this  chapter. 
Note  that  JCOLCR/JDCOLR  do  not  determine  polygon  interior 
color. 

J.   POLYGON  INTERIOR  COLOR  (JPIDEX/JDPIDX) 

1 •   Description 

JPIDEX/JDPIDX  are  the  subroutines  used  to  set  the 
current/default  polygon  interior  color. 

2.  Ose 

CALL  JPIDEX(CCOLOR,0)  (Current) 

or 
CALL  JDEIDX  (DCOLOR,  0)  (Default) 

3.  Parameter  Definitions 

CCOLOR    (Integer) 
The  polygon   interior  color  of  subsequent   polygons 
within  the  currently  open  segment.   (0<CCOLOR<8) 

DCOLOR    (Integer) 
The  new  value  for  the  default   polygon   interior 
color.   When  a  segment  is  opened,   the  interior   color  is 
reset  to  DCOLOR.   (0<DCOLOR<8) 

0    (Integer  number  zero) 
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Polygon     interior      style     cannot        be     specified  as 

described   in  Reference   1.        Therefore,    a   "0"    is   used   here  as 

a  placeholder  only.  All  interiors  can  be  "solid"  filled  or 
empty.      Hatching  is   not   supported. 

4 .      Applicability 

Applies    only  to   polygon   primitives. 

5-      Initialization   Default   Value 

DCOLOB=0        (No   interior   color) 

6  •      Discussion 

Polygon  interior  color  applies  only  to  polygons 
whose  interiors  have  been  specified  as  "filled"  using  the 
JPINTB/JDPINT  subroutines  with  value  one.  Interior  color  is 
not    specified  using    the   JCOLOR/JDCOLR   subroutines. 

The  following  color  index  table  is  applicable  to  the 
Ramtek  monitors  by  setting  CCOLOR/DCOLOR  to  the  integer 
values: 

0  —    Background    (No   color) 

1  —   Red 

2  —   Green 

3  —   Yellow 

4  —   Magenta    (Dark   Blue) 

5  —   Purple 

6  —  Cyan  (Light  Blue) 

7  —  White 

8  —    Background  complement    (White   also) 
Additional   cclors      may   be  specified  by     referring  to 

the  Reference  1  description  of  JCOTBL  (creating  a  color 
table).  (0<CCOLOR/DCOLOR< 32767)  is  the  actual  range  of 
permissible  values,  but  to  utilize  values  >8  your  color 
table  must  first  be  defined.  If  this  definition  is  not 
done,   the  colors  called   by    values  >8   will   be   unpredictable. 
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K.   POLYGON  PROGRAM  EXAMPLE 

Figure  3.2   is  a  complete   program  that  draws   a  polygon 
with  red  interior  and  yellow  border. 
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AT  THE  BEGINNING  OF  THE  PROGRAM  (BEFORE  THE  FIRST 
SEGMENT  IS  OPENED)  DEFAULT  COLOR  IS  SET  TO  GREEN. 


CALL  JDCOLR  (2) 


OPEN  SEGMENT  ONE  FOR  THE  GREEN  SQUARE,  CREATE  IT, 
TBEN  CLOSE  SEGMENT  ONE. 


CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 


JRCPEN 

JMOVE 

JDRAW 

JDRAW 

JDRAW 

JDRAW 

JRCLO 


OPEN    SEGMENT    TWO   FOR    THE    RED    SEMI-CIRCLE. 
NOTE    THAT    CURRENT    COLOR    ATTRIBUTE    IS    CHANGED 
WITHIN    SEGMENT    TWO    TO    RED.       CREATE    THE    RED 
CIRCLE,    THEN   CLCSE    SEGMENT    TWO. 


CALL   JROPEN  (2) 
CALL   JCOLOR  <1) 
CALL   JARC (0.,0.,0 
CALL    JRCLOS 


2. ,0,0. ,180.) 


Figure  3.1   Color  Segment  Program. 
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c 

c 
c 
c 
c 
c 


c 
c 
c 
c 


c 
c 
c 


c 
c 
c 

c 
c 
c 


THIS    PROGRAM    WILL    CREA 
DISPLAY   IT    WITH    A   RED 

INITIALIZE    THE    PROGRAM 
ASSIGN    VALUES    TC    NECES 

INTEGER    MON 
REAL    POSITX  (5)  ,POS 
/5.  , 


DATA 
DATA 


POSITX 
POSITY 


2. 

>6.;o. 


INITIALIZE    THE    RAMTEK 
DI-3000   INITIALIZATION 


TE    A    FIVE-SIDED    POLYGON    AND 
INTERIOR    AND    YELLOW    EDGE. 

.       DECLARE    VARIABLES,     AND 
SARY    ARRAYS. 


ITYJ5) 

5,-2.5.-6.5.7./ 
,-6.5,5. ,7.5/ 

MONITOR  AND  COMMENCE  MANDATORY 
SUBROUTINES. 


TYPE  *,  • ENTER 
ACCEPT  *,  MON 
CALL  JBEGIN 
CALL  JFILES 
JDINIT 
JDEVON 
JDCOLR 


THE  MONITOR  NUMBER1 


CALL 
CALL 
CALL 


3,1, MO 


CALL 
CALL 


JVSPAC 
JWINDO 


I- 


-1 

io;,i 


!S 
!P 

1 


N) 


ET  DEFAULT  COLOR  YELLOW  FOR  ALL 
OLYLINES  AND  THE  POLYGON  EDGE. 

6—.  8 ,  .  8) 
.,-8.  ,8.) 


OPEN    SEGMENT   ONE    AND    DRAW    THE    POLYGON. 


CALL  JROPEN  (1) 
CALL  JPIDEX 
CALL  JPINTR 
CALL    JPEDGE 


r 


CALL   JPOLGN(POS 
CALL    JRCLOS         !CLO 


PAUSE    THE    PROGRAM    SO   T 

SCREEN,    THEN    END   THE   P 


CALL   JPAUSE  (1) 
CALL   JEND 

END 


!SET  INTERIOR  COLOR  TO  RED. 
!FILL  VICE  NO-FILL. 
!SET  EDGE  STYLE  EVEN  SO 
!IT  WILL  BE  VISIBLE  AND  WILL 
!DRAW  USING  JDCOLOR  DEFAULT 
ICOLOR  YELLOW. 

ITX, POSITY, 5)   ICREATE  AND  DRAW 

!THE  POLYGON. 

SE  SEGMENT  ONE. 


HE  IMAGE  WILL  REMAIN  ON  THE 
ROGRAM. 


Figure  3.2   Typical  Polygon  Creation  Program. 
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IV.    TEXT   PRIMITIVES    AND    AT TRI BOTES 


A.       GENERAL 


Written  text  can  be  displayed  on  the  Ramtek  monitors. 
Subroutine  calls  exist  that  create  these  character  primi- 
tives and  control  test  attributes  such  as  orientation,  size, 
and   type. 

DI-3000  supports  four  different  levels  of  text  preci- 
sion. This  tutorial  will  describe  the  highest  level,  known 
as  graphic  arts  precision  text.  Each  character  in  a  graphic 
arts  string  is  "stroke  generated"  by  DI-3000  software, 
resulting  in  the  highest  possible  quality  of  text,  rather 
than  using  any  hardware  character  generator.  Learning  how 
to  create  graphic  arts  text  is  no  more  difficult  than 
learning  hew  to  create  the  lower  quality  types  because  all 
text    attributes    apply   universally. 

If  a  programmer  is  concerned  with  transmitting  a 
graphics  program  over  low  bandwidth  communications  lines, 
then  high  quality  text  creation  may  be  excessively  slow.  In 
this  case,  refer  to  Reference  1  for  a  description  of  lower 
level   text    using  the   J1TEXT ,   J2TEXT,    and   J3TEXT   commands. 

Text  primitives  are  only  defined  at  absolute  positions. 
There  are  no  corresponding  relative  subroutine  primitive 
calls. 

B.       TEXT   ATTRIBUTES 

As  with  non-text  attributes,  text  attributes  have  either 
default  cr  current  values.  Default  values  must  be  specified 
prior  tc  the  opening  of  the  first  segment,  and  current 
values  can  only  be  changed  while  a  segment  is  open  (within  a 
segment).  For  a  more  detailed  discussion  refer  to  Chapter 
III. 
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All  text  attributes  apply  only  to  text  primitives.  One 
non-text  attribute  applies  to  rext:  the  polyline  color 
command      (JCOLOR/JDCCLR) .  A   description      of     these      color 

subroutine   calls  can   be   found   in   Chapter  III. 

All  text  attributes  have  initialization  default  values. 
In  all  but  cne  case,  these  values  are  such  that  text  attri- 
butes need  not  be  changed  because  legible,  normal  characters 
are        output.  Only       the  character        size        attribute 

(JSIZE/JDSIZE)  must  be  specified.  Without  its  modification, 
the  text  will  be  much  too  small  to  be  readable  since  size  is 
specified  in  terms  of  world  coordinate  window.  The  16.0  by 
20.0  convention  chosen  for  the  examples  in  this  tutorial 
makes   this   size    change  necessary. 

C.       CREATING  A    CHARACTER   STRING    (JHTEXT) 

1  •      Description 

JHTEXT  is  the  subroutine  used  to  output  a  graphic 
arts    guality  text  string. 

2.  Use 

CALL   JHTEXT  (NCHARS, STRING) 

3 .  Parameter  Definition 

NCHARS         (Integer) 

The  number  cf  characters  in  the  text  string. 
(0<=NCHARS<=255)  . 

STRING         (Integer,    Hollerith   Input   String) 

The  actual,  literal  character  string  to  be  output. 
For  example,  a  STRING  value  of  18HTHIS  IS  AN  EXAMPLE  would 
output   THIS   IS    AN  EXAMPLE  on  the   monitor   screen. 

Note  --  STRING  must  be  an  Integer  type  variable.  If 
your  program  uses  CHARACTER*  variable  types,  they  must  be 
converted  tc  integer  before  using  them  as  parameters  in  this 
JHTEXT   subroutine  call. 
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STRING  can  also  contain  "sentinel"  characters  as 
discussed  below  for  changing  to  upper  or  lower  case,  under- 
lining,   cr    ether  special  functions. 

An   example      of  the      complete  JHTEXT      subroutine   call 
that    would   output  the  letters   THIS   IS   AN   EXAMPLE    follows: 
CALL    JHTEXT (18,  1 8HTHIS    IS    AN    EXAMPLE) 

U  •      Required  Attributes 

All  text  class  attributes  and  the  non-text  polyline 
color   attribute    JCOLCE/JDCOLR   apply. 

5-      Discussion    Example 

Characters  are  drawn  in  current  polyline  color  as 
defined  either  by  JCOLOR  or  JDCOLR.  Refer  to  Chapter  III 
for  a   description  of   these    attributes. 

If  increased  space  between,  or  overlap  of,  charac- 
ters  is   desired    refer  to  the   gap   attribute    (JGAP/JDGAP)  . 

Simple  block  letters  are  created  with  the  initial 
default.  If  more  artistic  styles  are  desired,  refer  to  the 
font    attribute    (JFONT/JDFONT) . 

Initial  character  size  will  be  too  small  to  be 
legible  using  the  ncrmal  size  attribute  default  and  the 
window  of  16.0  by  20.0  chosen  for  this  tutorial.  Therefore, 
the  JSIZE  or  JDSIZE  subroutines  must  be  used  prior  to 
writing  any  text  unless  very  small  world  coordinate  window 
size    is   chesen. 

Character  string  direction  will  be  "left-to-right" 
unless  specified  differently  by  changing  the  path  attribute 
(JPATH/JDPATH)  .  Various    angle      orientations     can   also     be 

specified  by  using  the  character  base  (JBASE/JDBASE)  and 
character  plane  (JPLANE/JDPLAN)  attributes  discussed  in 
Reference    1. 

Character  justification  will  begin  with  the  "lower- 
left-hand"    corner  of   the  string  corresponding   to   the   current 
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position    (CP)      on  the  screen.        Any   changes  to   justification 
can    be   made  by    changing  the    (JJUST/JDJUST)    attributes. 

All  text  prittitive  subroutine  calls  return  CP  to  its 
initial   position  when  the  call  completes. 

Sentinel  characters  are  allowed  within  the  STRING 
parameter  to  specify  different  functions.  All  sentinel 
character  functions  are  prefaced  by  the  start  command  (open 
bracket,  ■[•)  and  terminated  by  the  end  command  (closed 
bracket,    '  JM-      The    sentinel  character  functions    are: 

[BSOP]   —    Begin   superscript 
[ESOF]   —    End   superscript 
[BSOB]   —    Begin   subscript 
[ESOB]   —    End  subscript 
[BOC]   —    Begin   uppercase 
[EDC]   —    End   uppercase 
[BIC]   —    Begin   lowercase 
[EIC]   —    End  lowercase 
[BOND]   —    Begin   underline 
[EUNE]   —    End   underline 
[FONT^n]   —    Change  to   font   number    'n1 
Figure      4. 1    shows      examples   of      sentinels    and     their 
resulting  outputs. 

D.       CHARACTER    SIZE     ( JSIZE/JDSIZE) 

1 .      Description 

JSIZE/JDSIZE  are  the  subroutines  that  set  the 
current/default    text   primitive  character   size. 


2.      Use 


CALL    JSIZE(CXSIZE,CYSIZE)  (Current) 

or 
CALL    JDSIZE(DXSIZE,DYSIZE)  (Default) 
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3 .      Parameter  Def initio n 

CXSIZE,CYSIZE         (Real) 

The  size  of  a  character  within  the  currently  open 
segment. 

DXSIZE,DYSIZE  (Real) 

The  new  value  for  the  default  size  of  a  character. 
When  a  segment  is  opened,  character  size  is  reset  to 
DXSIZE,DISIZE. 

CXSIZE/DXSIZE  are  widths  (in  the  X-axis  direction) 
and  CYSIZE/DYSIZE  are  heights  (in  the  Y-axis  direction) . 
They    are  expressed   as  world   coordinate   values. 

*•      Initialization   Default   Value 

DXSIZE/DYSIZE    =    0.02 

5  •      Discussion 

JSIZE/JDSIZE  parameters  are  expressed  as  world  coor- 
dinates. Therefore,  since  JWINDO  specifies  the  world  coor- 
dinate grid  there  is  a  direct  relationship  between  window 
and  character  size.  Both  dimensions  will  be  defined  in 
terms  of  the  same  units.  Polyline  and  polygon  primitives 
also    use  these    world   coordinate   units. 

E.       CHARACTER    SPACING    (JGAP/JDGAP) 

1 .      Description 

JGAE/JDGAP  are  the  subroutines  that  set  the 
current/default    text    spacing    (gap)    between   characters. 


2.      Use 


CALL    JGAP(CVALUE)  (Current) 

or 
CALL    JDGAP(DVALOE)  (Default) 
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3 .   Parameter  Definitions 

CVALOE    (Real) 
The  spacing  between  characters   within  the  currently 
open  segment.   (CVALOE  >  -1.0) 

DVALOE    (Real) 
The  new  value  for  the  default  spacing  between  char- 
acters.   When   a  segment   is  opened,    spacing  is  reset  to 
DVALOE.   (DVALOE  >  -1.0) 

**•   Initialization  Default  Value 

DVALOE  =  0.0    (Normal  spacing) 

5 .   Discussion 

The  spacing  between  characters  is  defined  as  a 
multiple  of  character  width.  Therefore,  if  CVALOE/DVALOE  = 
1.0  there  will  be  a  space  between  each  character  box  equiva- 
lent to  the  width  of  a  normal  character  (for  example,  an 
•N«)  . 

Notice  that  when  CVALOE/DVALOE  =  0.0  there  is  still 
some  space  between  characters.  This  is  because  each  char- 
acter is  surrounded  by  a  character  box  that  contains  ncrial 
pad  space  so  that  text  does  not  "run  together." 

Text  can  be  made  to  partially  or  completely  overlap 
by  setting  CVALOE/DVALOE  <  -.25.  CVALOE/DVALOE  =  -.25  makes 
the  characters  "touch"  each  other,  and  CVALOE/DVALOE  =  -1.0 
superimposes  all  characters  onto  a  single  location. 

F.   CHARACTER  STRING  DIRECTION  (JPATH/JDPATH) 

1 .   Description 

JPATH/JDPATH  are  the  subroutines  that  set  the 
current/default  text  primitive  character  direction  (path). 
Normal  direction  is  "left-to-right." 
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2.  Use 

CALL    JPATH(CVALUE)  (Current) 

or 
CALL    JEEATH(D VALUE)  (Default) 

3.  Parameter  Definition 

CVALUE         (Integer) 
The     direction     of      a   character      string      within      the 
currently   open    segment.       (CVALUE=1    thru   4) 

DVALUE         (Integer) 
The  new      default  value      for  character     string   direc- 
tion.        When     a    segment     is    opened,        direction   is      reset   to 
DVALUE.        (DVALUE  =  1    thru    4) 

** •      Initialization  Default  Value 

DVAIUE=1         (left-to-right) 

5 .      Discussion 

Character  strings  can  be  generated  in  four  different 
directions  using  the  JPATH/JDPATH  subroutines  by  setting 
their   parameters  to    the   following   values: 

1  —   left-tc-right    (character   path  right) 

2  —   top-to-bottom       (path   down) 

3  —   r ight-tc-left      (character   path   left) 
a    —   bottom-to-top       (path   up) 

Values  3  and  4  will  result  in  inverted  characters 
unless  used  in  conjunction  with  base  and  plane  manipulation 
as      discussed  in      Reference    1.  Normal      directions   can     be 

generated   using    values   1   or    2. 

Figure  4.2  is  an  example  of  the  four  possible  path 
settings. 


61 


G.   CHARACTER  STRING  JUSTIFICATION  (JJOST/JDJOST) 

1 .  Description 

JJOST/JDJOST  are  the  subroutines  that  set  the 
current/default  text  primitive  character  string  justifica- 
tion. The  justification  point  is  the  starting  position  of  a 
character  string.  It  lies  "within"  the  string  (for  example, 
the  "lower-left-hand  corner,"  or  the  "center"  of  the 
string).      Figure  4.3    shows   examples  of   string   justification. 

2.  Ose 

CALL  JJ0ST(CHORIZ,CVERT)  (Current) 

or 
CALL    JDJ0S1(DH0RIZ,DVERT)  (Default) 

3 .  Parameter  Definition 

CHCRIZ/CVERT         (Integer) 
The   horizontal/vertical   justification   of    a   character 
string   within  a    currently  open   segment.         (CHORIZ ,CVERT=1 ,2, 
or   3) 

DHCRIZ/DVERT         (Integer) 
The  new     default   value      for  the      horizontal/vertical 
character   string   justification.        When     a   segment   is  opened, 
justification  is  reset       to  DHORIZ  and  DVERT. 

(DH0RIZ,DVERT=1,  2,    or   3) 

4.  Initialization  Default   Value 

DHORIZ, DVERT=1  (bottom    left) 

5 •      Discussion 

Character  string  justification  values  are  defined  as 
follows: 

CHORIZ/DHORIZ  CVERT/DVERT 

1  --  left  1    --   bottom 

2  --  center  2   —   center 
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3  —  right  3  —  top 

The  justification  point  refers  to  the  position  indi- 
cation "dot"  shown  en  the  examples  in  Figure  4.3.  When  a 
text  primitive  string  is  created,  -chis  point  is  overlaid 
(mapped)  onto  current  screen  position  (CP) ,  thus  providing 
for  nine  different  orientations. 

H.   CHARACTER  STYLE  (JFONT/ JDFONT) 

1 .  Description 

JFONT/JDFONT  are  the  subroutines  that  set  the 
current/default    character  style    (font)  . 

2.  Dse 

CALL    JFONT (C VALUE)  (Current) 

or 
CALL    JDFONT(DVALDE)  (Default) 

3 .  Parameter  Definition 

CVALOE         (Integer) 
The     style      type     of  a      character     string      within     a 
currently  open    segment.      (1<=CVAL0E<=12) 

EVALOE         (Integer) 
The     new  default     value      for     character  style     type, 
when    a     segment   is   opened,      style     type   is   reset      to   DVALUE. 
(1<=DVALDE<  =  12) 

4 .  Initialization   Default   Value 

DVAL0E=1  (simplex    block) 

5 .  Discussion 

There  are  six  different  character  style  fonts  avail- 
able. Each  can  be  generated  in  block  or  italics  (right- 
slanted)  orientation.  The  following  CVALUE/DVALOE  values 
are   used  to   specify    style: 

63 


1  —   simplex  block  7  --  triplex  block 

2  —  simplex  italics  8  --  triplex  italics 

3  —   duplex   block  9  --   Greek   block 

4  —   duplex   italics  10  --   Greek   italics 

5  —   complex  block  11  —   script  block 

6  —  complex  italics  12  —   script   italics 
Figure   4.4    gives  examples  of   the   six   basic   character 

style   fonts. 
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V.    BEQOIRED    SOBROOTINES 


A.  GENERAL 

Figure  1.1  is  an  example  of  the  minimum  set  of  subrou- 
tine calls  necessary  to  run  any  DI-3000  graphics  program. 
The  program  harness  is  not  meant  to  be  an  exhaustive  list  of 
all  possible  control  commands,  but  it  does  provide  for  all 
basic  initialization,  primitive  creation,  primitive  visi- 
bility,   and  termination   requirements. 

The  remainder  of  this  chapter  will  describe  the  commands 
listed  and  alternative  subroutine  calls  if  they  apply.  Seme 
terminology  already    defined    will   be  used. 

B.  INITIALIZATION     (JEEGIN) 

1 .  Description 

JBEGIN  is  the  subroutine  call  used  to  begin  the 
DI-3000  graphics  portion  of  an  application  program.  It  sets 
all  default  parameter  and  attribute  values  to  their  initial- 
ization  state. 

2.  Use 

CALL   JEEGIN         (No   parameters) 

3 .  Discussion 

Any  Fortran  statements  in  the  application  program 
may  precede  or  follow  the  JBEGIN  call  if  they  adhere  to  the 
standard,  required  crder  of  Fortran  statements  and  lines  as 
described  in  Reference  2.  But,  JBEGIN  must  be  the  first 
DI-3000     statement.  It      begins      the      application      program 

graphics  section. 
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JBEGIN      does   not     specify      an      output   device.  The 

JFILES,  JDINIT,  and  JDEVON  commands  are  used  after  JBEGIN  to 
define,  initialize,  and  select  the  Ramtek  monitor  pair  to  be 
used    for  display. 

C.       SELECTING    AHD   OPEBATING    RAMTEK    MONITORS 
1 .      Discussion 

The  war  lab  has  three  graphics  processors  and  two 
Ramtek  mcnitors  for  each  processor.  Before  trying  to  use 
one  of  the  available  units  the  programmer  must  verify  that 
at  least  one  monitor  pair  is  not  already  in  use.  There  are 
three   pairs     currently  accessible.  Figure    1.1      provides  a 

typical  monitor  configuration.  Each  monitor  can  be  identi- 
fied as  belonging  to  monitor  pair  1,  2,  or  3  by  the  label 
beneath  the  screen.  If  you  try  to  access  a  pair  in  use  your 
program   will  run-terninate    with  an  error. 

A  program  could  be  written  that  would  only  access  a 
single  monitor  pair,  but  this  would  limit  the  user.  To  make 
all  programs  able  to  use  all  monitors,  the  following  two 
Fortran  statements  are  included  in  the  Figure  1.3  program 
harness  and  must  precede  the  JBEGIN  call  in  any  application 
program: 

TYPE    *,     'ENTER  THE    MONITOR    NUMBER1 
ACCEPT   *,    MON 

Fortran  programmers  may  be  unfamiliar  with  these 
statements  because  they  are  VAX- 11  Fortran  extensions  to  the 
Fortran-77  standard.  TYPE  merely  gueries  the  user  at  the 
terminal  (interactively  during  program  run)  as  to  which 
monitor  pair  is  intended  for  use.  ACCEPT  inputs  the  monitor 
number  and  stores  it  in  an  integer  variable  location  named 
MON    for   later  use  in   the  JFILES   subroutine  call. 

Both  screens  of  a  monitor  pair  do  not  need  to  be 
energized   unless  you   wish  to      display   two   identical    pictures 
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simultaneously.  Befcre  running  your  program,  insure  that 
the  two  Ramtek  front  panel  toggle  switches  are  in  the  "up" 
positions  and  that  the  brightness  knob  is  turned  fully  coun- 
terclockwise. There  is  a  one  minute  warm-up  time  required 
if  the   screens    were    previously  deenergized. 

D. "    DEFINIHG  HONITOB    ONIT   PAIE    NOMBEB    (JFILES) 

1 .  Description 

JFILES  is  the  subroutine  call  that  determines  which 
Bamtek  mcnitor  pair  will  display  the  graphics  image. 

2.  Ose 

CALL  JFILES  (C0DE,1 ,MONNUM) 

3.  Parameter  Definition 

CODE        (Integer) 
A  code      that    indicates      which   DI-3000      internal   file 
will    be   overridden.       Normally   C0DE=3.         If   graphics   input   is 
to   be   done   using  the   input   tablets,    CODE=4   is  required. 

1         (Integer   number   one) 
Required  because     of  current     file   specification     as 
implemented  on   the    VAX  operating  system   in   the  War   Lab. 

MONNUM         (Integer) 
The   monitor      pair  number   to      be   used   to      display  the 
application   program    graphics  picture.       (MONNUM=   1,2,    or  3) 

4 .  Discussion 

MCNNUM  can  be  any  variable  name  used  by  the  applica- 
tion program  to  indicate  monitor  pair  number.  If  the 
program  harness  of  Figure  1 .3  is  used,  then  MONNUM  must  be 
the    variable  named    MCN: 

CALL   JFILES (3, 1,M0N) 
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If  a  user  knows  that  a  certain  screen  pair  will 
always  be  used,  an  integer  value  of  1,  2,  or  3  can  instead 
be  used  as  MONNOM  value.  For  example,  if  screen  pair  2  were 
always  to   be  used  the  following  statement   would  apply: 

CALL   J  FILES  (3,  1,2) 

E.  INITIALIZATION    AND   SELECTION     (JDINIT/JDEVON) 

1 .  Description 

JDINIT  and  JEEVON  are  the  subroutine  calls  that 
initialize  and  then  select,  respectively,  display  devices. 
They  must  be  included  in  the  mandatory  sequence  of  DI-3000 
subroutine   calls. 

2.  Ose 

CALL   JEINIT(MON)  (Must   be   in   this    order) 

CALL    JDEVCN(MON) 

3.  Parameter  Definition 

HON        (Integer) 
The  current    version   of   DI-3000   assigns  device   number 
one    to     all  Ramtek    display      monitors.        This   number     must   be 
used      as     the      parameter     value     of      both     subroutine      calls 
(M0N=1)  . 

4 .  Discussion 

JDINIT (MON)  and  JDEVON(MON)  must  precede  any  default 
attribute  declaration  subroutines  or   any   segments. 

F.  SPECIFYING    COLOB 

1 .      Discussion 

A  color  must  be  specified  if  any  polylines  or  text 
are   to   be     visible.        Either  the   JDCOLR      subroutine   prior  to 
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opening  the  first  segment,  or  the  JCOLOR  subroutine  within 
each    segment  can  be    used. 

If  polygons  are  to  be  created,  use  the  polygon  color 
attributes  JPIDEX/JDEIDX  in  conjunction  with  the  interior 
style   attributes  JPINTR/JDPINT. 

In  general,  for  the  beginning  user  it  is  a  safe 
practice  to  always  specify  a  polyline  default  color  prior  to 
opening  the  first  segment.  This  is  done  in  the  Figure  1.3 
program  harness  example  with  the  JDC0LR(2)  subroutine  call. 
Since  color  value  2  is  used,  polylines  and  text  would  be 
drawn   in  green. 

6.       DBFIHING  COORDINATE    ASPECT    RATIO    (JVSPAC) 

1 .  Description 

JVSEAC  is  the  subroutine  call  that  defines  the 
actual  Ramtek  monitor  screen  area   to   be   used. 

2.  Use 

CALL    JVSPAC  (-1.0, 1.0, -.8, .8) 

3 .  Discussion 

Real  number  parameters  -1.0,  1.0,  -.8,  and  .8  should 
be  used  where  indicated  if  the  maximum  screen  area  available 
is   to      be  utilized.  Ramtek  GM859C     color  monitors      have  a 

defined  virtual  coordinate  display  area  ±1.0  unit  wide  by 
±.8  units  high,  referenced  to  an  invisible  screen  center 
point  at  (0.,0.).  Cther  values  would  not  fully  utilize  the 
available   screen  surface. 

Portions  of  the  screen  can  be  used  by  varying  JVSPAC 
parameters.  The  height-to-width  ratio  (.8)  must  be  iden- 
tical for  these  parameters  and  the  JWINDO  parameters  if  no 
distortion  is  to  occur  during  the  "mapping"  of  world  coordi- 
nate   picture  onto  virtual  coordinate  space. 
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For  a  further  description  of  JVSPAC,  see  Reference 
1. 

B.       DEFINING  WORLD    COORDINATE    WINDOW    (JWINDO) 

1 .  Description 

JWINDO  is  the  subroutine  call  that  defines  the  world 
coordinate  system.  All  text  and  image  points  in  a  program 
are    referenced    to  this  grid. 

2.  Use 

CALL    JWINDO(XMIN,XMAX,YMIN,YMAX) 

3.  Parameter  Definition 

XMIN,XMAX         (Real) 
The   minimum   and   maximum      world   coordinate    boundaries 
in   the   hori2ontal    (X-axis)     direction. 

YMIN,YMAX  (Real) 

The  minimum  and  maximum  world  coordinate  boundaries 
in   the   vertical    (Y-axis)    direction. 

4 .  Discussion 

The   world  coordinate     system  of   this   tutorial      is  an 
area    16.0      units  high     by   20.0      units   across,        chosen   arbi- 
trarily.     The   following   command   specifies  this  system: 
CALL    JWINDO(-10.0, 10.0,-8.0,8.0) 

Any  real  values  could  have  been  selected,  but  they 
would  have  to  match  the  .8  height-to- width  ratio,  specified 
by  the   JVSPAC  subroutine  call,    for  no   distortion   to   occur. 

JWINDO  can  be  used  to  "blow  up"  or  "shrink"  images 
merely  by  changing  its  parameter  values.  For  example,  if  a 
user  wants  to  double  the  size  of  an  image,  then  the  JWINDO 
parameters  should  be  halved.  This  is  analagous  to  an  object 
existing  in     some   world     system,      then      finding   itself     in  a 
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world  half  the  previous  size.  The  objects  size  would  seem 
to   have    doubled. 

Distortions  can  also  be  created  by  changing  height- 
to-width  ratios    to   values  other  than   .8. 

JWINDO   cannot  be  called  while   a   segment  is  open. 

I.       SEGMENT    REQUIREMENTS 

1 •      Discussion 

The  JR0PEN(1)  and  JRCLOS  statements  in  Figure  1.3 
tegin  and  end  a  retained  program  segment.  All  images  must 
be  created  within  a  segment.  For  images  that  can  all  appear 
on  the  screen  at  once,  the  program  harness  segment  state- 
ments given  will  be  adequate.  Segments,  and  their  visi- 
bility,   are   discussed  in  detail  in  Chapter   VI. 

J.       ENDING    A  GRAPHICS   PROGRAM    (JEND/END) 

1 .  Description 

JEND  is  the  subroutine  call  that  terminates  the 
DI-3000    graphics  portion  of    an   application    program. 

2.  Use 

CALL   JEND         (No   parameters) 

3 .  Discussion 

JEND  must  be  the  last  DI-3000  statement  in  an  appli- 
cation program.  Any  Fortran  statements  may  precede  or 
follow  JEND  if  they  adhere  to  the  standard  required  order  of 
Fortran   statements   and  lines  as   discussed  in   Reference    2. 

JEND  insures  that  the  Ramtek  monitors  previously 
initialized  and    selected  are   de-selected  and   terminated. 

The  END  command  in  Figure  1.3  is  a  standard  Fortran 
statement,  and  must  be  the  last  statement  of  any  application 
program. 
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VI-  DISPLAYING  AN  IMAGE 

A.   GENEBAL 

In  addition  to  defining  the  shape  and  position  of  a 
primitive,  a  user  can  control  when  a  DI-3000  picture  will  be 
displayed  during  program  run.  Also,  simple  images  can  be 
combined  to  create  complex  figures,  and  any  combination  of 
statements  can  be  grouped  together  to  form  a  program  segment 
that    can  be   made  visible  or    invisible  as   a   unit. 

Normal  execution  of  an  application  program  will  cause 
the  DI-3000  graphics  image  to  appear  on  the  selected  monitor 
pair,  but  the  picture  will  clear  immediately  when  the  job 
ends.  A   description     of    how     to     "pause"   a     program   so     a 

display  can   be    held   for   extended   viewing  is   included. 

This  chapter  explains  how  to  control  these  functions, 
and  discusses  some  image  overlay  limitations  associated  with 
the    War   Lab   graphics  system   as   configured. 

6.       SEGMENTS 

A  segment  defines  part  of  a  whole  picture  of  logically 
related  objects      (a    graphics     data  structure) .  A    complete 

graphics   image   normally   consists   of   a   seguence  of    segments. 

Each  segment  is  a  series  of  DI-3000  primitive  and 
current  attribute  calls.  Every  statement  that  creates  a 
primitive  must  be  contained  within  a  segment.  Only  default 
attribute  and  initialization  subroutines  can  exist  outside 
this    data  structure. 

An  entire  image  creation  seguence  can  be  contained 
within  a  single  segment,  but  multiple  segments  are  often 
used  to  partition  a  program  into  more  easily  understandable 
parts.      This  technique  also   aids   in  error   diagnosis. 
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There  are  two  segment  types:  temporary  and  retained. 
Temporary  segments  are  only  displayed  once.  If  they  are 
ever  cleared  from  the  screen  they  cannot  be  restored. 
Retained  segments  are  "named"  segments  that  can  be  made 
visible  and  invisible  as  often  as  desired.  In  general,  the 
retained  segment  offers  the  programmer  more  control  over  the 
picture  and  is  the  recommended  type.  A  retained  segment  is 
used  in  the  example  program  harness  of  Figure  1.3  in  Chapter 
I. 

When  any  segment  is  opened,  the  current  position  (CP)  is 
set  tc  zero  (0.,0.)  and  all  attributes  are  reset  to  their 
default   values. 

C.       IMAGE   OVERLAY    LIMITATIONS 

The  Bar  Lab  graphics  system  utilizes  certain  conventions 
that  can  be  limiting  if  compound  images  are  desired.  For 
example,  if  two  or  more  primitives  occupy  the  same  pixel 
position  on  a  screen  the  resultant  image  color  will  be  a 
blend  of  the  individual  colors.  This  problem  is  not  easily 
overcome,  but  sometimes  can  be  corrected  as  follows.  After 
drawing  the  second  image  over  all  or  part  of  the  first,  the 
original  image  is  made  invisible  by  using  the  JVISBL 
command.  When  this  is  done,  only  the  overlaid  portion  of 
the  first  image  will  disappear.  A  complete  display  of  true 
color  will  result  fcr  both,  but  this  technique  can  become 
very   complicated   for    multiple   images. 

A  second  method  involves  accessing  the  Ramtek  pixel  data 
and  conducting  a  bit-plane-erase  as  described  in  Reference  1 
under  Escape  Functions.  Trying  to  "black  out"  color  by 
drawing  with  background  color  "0"  does  not  work  because  you 
will    actually  be   drawing   with   "nothing." 

Polygon  interiors  are  filled  with  color  until  they 
encounter      a  border,        but      this   does      not      have      to   be      the 
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polygons  own  border.  If  another  polygon  edge  is  encoun- 
tered during  the  fill  of  an  overlaying  polygon,  the  fill 
will  often  stop.  Again,  using  the  JVISBL  command  to  make 
the  original,  overlaid  polygon  invisible  will  often  correct 
this  problem  because  the  limiting  border  will  be  removed. 

When  polygons  are  created,  their  defining  points  can 
cause  their  edge  lines  to  intersect  if  the  point  seguence  is 
incorrectly  specified.  This  intersection  will  actually 
create  more  than  one  polygon.  When  color  fill  is  attempted 
it  will  stop  at  the  first  intersection  point  rather  than 
completing  the  interior  color  of  the  whole  shape.  Defining 
the  shapes  as  multiple  polygons  corrects  this  problem. 

D.   CBEATIHG  A  TEMPOBABX  SEGMENT  (JOPEN/JCLOSE) 

1 .  Discussion 

JOPEN/JCLOSE  are  the  subroutine  calls  that  begin/end 
a  temporary  segment. 

2.  Use 

CALL   JOPEN 
(sequence   of   DI-3000  subroutine   calls) 
CALL   JCLOSE 

3 .  Discussion 

Temporary     segments     exist     only     once.  Refer     to 

JROPEN/JBCLCS   for  a    discussion   of  retained   segments. 

Befer  to  Section  B  of  this  chapter  for  a  description 
of  segments  in   general. 
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E.  CREATING  A  RETAINED  SEGMENT  (JROPEN/JRCLOS) 

1 .  Description 

JROPEN/JRCLOS  are  the  subroutine  calls  that 
begin/end   a  retained   segment. 

2.  Dse 

CALL   JROPEN(NAME) 
(Sequence   of   DI-3000  subroutine   calls) 
CALL   JRCLOS 

3.  Parameter  Definition 

NAME         (Integer) 
The     name  of     the     retained      segment   to      be     opened. 
(1<NAME<32000) 

4  •      Discussion 

Retained  segments  can  be  made  visible  or  invisible 
using   the   JVISBL/JDVSEL  subroutine   calls. 

All  retained  segments  can  be  cleared  from  the  screen 
using  the   JFRAME  and   JVISBL   subroutine  calls   together. 

Retained  segments  can  be  erased  from  memory  using 
the    JCLEAR   subroutine  call. 

Refer  to  Section  B  of  this  chapter  for  a  description 
cf   segments  in   general. 

Note  —  JRCLCS  does  not  require  the  name  of  the 
retained   segment  as    a  parameter. 

F.  MAKING    SEGMENTS    VISIBLE     (JVISBL/JDVISB) 

1 .      Description 

JVISBL/JDVISE  are  the  subroutines  that  determine  the 
visibility/default    visibility  of   retained   segments. 
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2.  Use 

CALL    JVISEL(NAME,VISFLG)  (Immediate) 

or 
CALL    JDVISB(VISFLG)  (Default) 

3 .  Parameter  Definitions 

NAME         (Integer) 
The   name     of   the     retained   segment      whose    visibility 
attribute   will    be  changed. 

VISFLG         (Integer) 
An     integer    value     that   controls      the  visibility     of 
retained  segments,       (VISFLG=0   or    1) 

Default    value  is  one    (visible)  . 

4 .  Discussion 

The   following  VISFLG  values   apply: 

0  --   Retained   segment  invisible 

1  --   Retained  segment   visible 

JVISBL  is  used  to  remove  or  restore  the  image  of  a 
retained   segment  onto  the  screen. 

JDVISB  sets  the  default  visibility  of  all  retained 
segments. 

Note  —  Neither  subroutines  can  be  called  within  a 
segment    (JVISBL    is   net  a  current  subroutine   call) . 

Both  JVISBL  and  JDVISB  can  make  segments  visible  and 
invisible. 

G.       CLEAEING  THE   SCREEN    (JFRAME) 

1 .      Description 

JFRAME  is  the  subroutine  used  to  clear  the  monitor 
screen  in  preparation  for  a  new  drawing  area  within  a 
program. 
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2.   Dse 

CALL  JFRAME    (No  parameters) 
3 •   Discussion 

JFRAME  will  cause  all  temporary  segments  to  be 
removed  from  the  screen-  All  retained  segments  will  be 
removed,  then  will  be  redrawn  based  upon  their  visibility 
attribute  as  specified  by  J VISBL/JDVISB. 

JCLEAR  will  not  only  remove  all  retained  segments 
from  the  screen,  but  will  erase  them  from  memory  as  well. 
After  using  JCLEAR  a  retained  segment  cannot  be  displayed 
again.  Reference  1  contains  a  detailed  description  of 
JCLEAR. 

B.   PAUSING  A  PROGRAM  (JPAUSE) 

1 .  Description 

JPAOSE  is  the  subroutine  used  to  pause  a  graphics 
program   during   execution. 

2.  Dse 

CALL    JPA0SE(1) 

3.  Parameter  Definition 

1         (Integer   number  one) 
Required  by    operating   system  device  assignment. 

*  •      Discussion 

The  JPAOSE  statement  can  be  inserted  anywhere  in  a 
DI-3000  program,  after  JDINIT  and  before  JEND.  It  is  used 
to   hold   the  image  on   the  screen   for  extended   viewing. 

A  request  message  will  appear  on  the  VT-100/2  screen 
during  the  pause.  Depressing  the  return  key  on  the  terminal 
will   cause   the    program  to  continue. 
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Every  application  program  should  include  at  least 
one  JPMJSE  statement  after  all  segments  have  been  created. 
If  the  program  is  not  "paused"  during  execution,  it  will 
immediately  exit  at  run- completion  and  the  screen  will 
clear. 


82 


Til.  CONCLUSION 

A.       ADDITIONAL    CAPABILITIES 

This  tutorial  has  only  described  the  basic  graphics 
features  available  in  the  War  Lab.  A  brief  discussion  of 
additional  capabilities  follows.  Detailed  explanations  can 
be   found  in  Reference   1. 

Graphics  input  can  be  read  by  using  the  logical  input 
functions  and  the  input  tablet  hardware.  The  functions 
request  input  from  the  operator  and  pass  the  values  to  the 
calling  program.  The  Chart  and  Sketch  Program,  written  by 
CAPT  Tschudy  and  available  to  users  in  the  War  Lab,  makes 
extensive  use  of  DI-3000  input  subroutines  for  interactive 
query  and   selective    display. 

Scaling  can  be  dene  that  results  in  distorted  images  or 
varied   image  sizes.  All    previous   examples   have      been  two- 

dimensicnal  (2D)  pictures,  but  the  ability  to  create  three- 
dimensional  (3D)  objects  exists.  The  2D  or  3D  images  can  be 
rotated  throughout  all  possible  configurations,  and  can  be 
viewed  from  any  translation  point  in  space  by  using 
different   modeling   transformations. 

Each  error  generated  in  DI-3000  is  assigned  a  "severity 
level,"  and  a  "threshold"  error  level  can  be  set  that  will 
either     terminate  or     allow   a      program      to   continue.  This 

selective  error  processing  feature  is  particularly  helpful 
during   program    development    and    debugging. 

System  inquiries  can  be  made  that  pass  current  values, 
default  values,  modes,  and  status  information  back  to  the 
application  program.  This  capability  is  useful  in  interac- 
tive   programs  that    rely   on    dynamic   parameters. 
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Calling  programs  can  "escape"  to  the  Ramtek  hardware 
itself      for  control      of     device-dependent   routines.  These 

escape  functions  often  complete  processes  more  quickly  by 
using  hardware  routines  rather  than  DI-3000  software.  The 
immediate  display  of  all  screen  "pixel"  data,  rather  than  a 
slow  software  update,  is  an  example  of  a  typical  escape 
function. 

8.       HELP    FEATURE 

The  operating  system  provides  users  with  a  DI-3000 
"help"  feature.  Printouts  that  discuss  common  graphics 
problems,  and  solutions  to  typical  difficulties,  are 
displayed  on     the  terminal    screens.  To   access      the   "help" 

library,   after    log-in  type: 

HELP   DI3000 

A  menu  will  appear  with  topic  subsections  that  can  then 
be  specified  by  typing  the  given  topic  name. 

In  general,  "help"  listings  are  designed  to  aid  mere 
experienced  users. 

C.   SAMPLE  PROGRAMS 

Sample  programs  exist  that  can  be  used  to  compare 
displayed  images  to  the  Fortran  listings  that  create  them. 
Users  can  output  the  listings  to  their  terminal  screens  or 
to  the  printer  in  the  War  Lab  machine  room.  The  graphics 
images  will  appear  en  a  monitor  pair  that  is  selected  in 
response  to  an  interactive  query  during  program  run. 

To  run  a  demonstration  program,  after  normal  user  log-in 
type  the  following  command: 

RUNDEMC  (Sample  Program  Number) 
For  example,    if  sample  program  number   2  is  to  be  run  and 
displayed  on  a   monitor,   the  following  complete   command  is 
typed  and  entered  with  a  <CR>  (carriage  return)  : 

RUNDEMO  2 
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A  request  fcr  monitor  number  will  then  appear  on  the 
terminal  screen.  After  typing  the  desired  monitor  number 
and  entering  it,  tte  demonstration  program  will  run  and 
display  the  image.  The  Ramtek  monitor  you  choose  must  be 
energized  and  cannot  already  be  in  use. 

There  are  several  ways  to  exit,  or  end  the  programs. 
Most  require  a  <CR>  response  to  a  pause  message,  but  demon- 
stration programs  21-25  contain  FORTRAN  PAUSE  commands  that 
require  the  following  entry: 

C  <CR> 

All  programs  can  be  terminated  at  any  time  by  typing 
<CTRL>   and   Y  simultaneously. 

To  cause  the  Fortran  program  listing  to  appear  on  the 
terminal  screen,    type  the  following: 

TTPEDEMO    (Sample   Program  Number) 
To   stop   the  screen   frcm   "scrolling"    past   the   program   portion 
you    wish  to   view,    depress  the   <N0  SCROLL>   key. 

To  print  a  hard  copy  of  the  Fortran  listing,  type  the 
following: 

PRINTDEMO    (Sample   Program  Number) 

Seme  of  the  sample  programs  correspond  to  figures  in 
this  tutorial,  and  are  indicated  as  such  in  the  following 
sample   program   index: 

DEMO    NUMBER  DESCRIPTION 

1  Absolute   square 

2  4    Relative   squares 

3  Successful   polygon   overlay 

4  Absolute    broken  line    (Figure   2.1) 

5  Relative    broken   line    (Figure   2.1) 

6  Arc  line 

7  Distorted  arc  (center  off  screen) 

8  Polygon  (Figure  2.2) 

9  Rectangle 

10  Filled  circle 

11  Circles    (Figure   2.3) 
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12  Circle  section  (Figure  2.5) 

13  Text,  default  attributes 

14  Text,  large  letters 

15  Text  and  polygon,  normal  size 

16  Text,  different  font 

17  Text,  vertical  path 

18  Text,  wide  gap 

19  Text,  overlap  gap 

20  Text,  base  and  plane  change 

21  Text,  italics 

22  Sine  waves  plot 

23  Text,  base  line 

24  Text,  transformations 

25  Interactive  Input 

1 .      Suggested  Thesis  Topics 

A  student  with  a  desire  to  work  with  the  graphics 
system  could  contribute  to  War  Lab  system  capability. 
Polygon  overlay  and  3D  transformation  features  could  be  more 
thoroughly   investigated. 

An  extensive  color  table  needs  to  be  created.  Seme 
type  of  interactive  method  for  users  to  select  desired 
colors  cculd  be    developed. 

This  tutorial  could  be  made  into  an  interactive 
program,  and  further  documentation  of  the  advertised  DI-3000 
capabilities  that  are  not  applicable  to  the  War  Lab  system 
could   be  generated. 
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